02 · 全库文件地图（逐文件清单）
顶层文档（5）
02 · 全库文件地图（逐文件清单）
分区页：从 00 驾驶舱（投资MOC） §〇·五 拆出。要什么：「我要找 X 文件 → 它在哪」。
驾驶舱 §〇·五 只保留目录级声明数（
scripts/arch_check.py检查项 7 校验口径），逐文件清单在此。返回入口：00 首页（从这里开始）
按用途找（先看这张表）
| 我想找… | 去这里 |
|---|---|
| 今天的收盘复盘 / 最近一次复盘 | 复盘/复盘索引（时间倒序，第一屏即是） |
| 某个数据源的单位与口径 | 数据库说明 |
| 全局口径定义（冲突时以此为准） | 框架/数据口径定义 |
| 操作手册 / 日常流程 | 框架/使用指南 |
| 自动化技能（九步 SOP） | 框架/技能/duckerry-daily-review SKILL · 框架/技能/reference |
| 模拟盘账户视图 | 模拟盘看板 |
| 管线怎么跑 / 哪个脚本干什么 | 分区/01 系统架构与脚本 |
| 框架 / 资产 / 因子 / 概念页 | 分区/03 框架·资产·因子·概念 |
| 某结论是否已被验证或证伪 | 分区/04 验证追踪与Agent系统 |
| 里程碑与专题复盘 | 分区/05 复盘导航与里程碑 |
| 这个版本改了什么 | 分区/06 版本记录 |
| 系统优化报告与历史审计 | 本页 §三 之下 + 分区/02 全库文件地图 |
| 回测引擎与审核清单 | 回测/README · 回测/回测审核清单_backtest_pitfalls |
| 审计证据包（平时别打开） | audit_evidence/index |
逐文件清单（附录）
本节是"每个文件至少有一条入链"的保证。 任何目录下的任何文件都可从这里一键到达；数量口径为 2026-09-23 实测（新增文件后请同步
scripts/arch_check.py检查项 7）。
顶层文档（5）
| 文件 | 用途 | 类型 |
|---|---|---|
| 00 驾驶舱（投资MOC） | 全库唯一入口（本页） | 入口 |
| 模拟盘看板 | 模拟盘「真实账户视图」（自动生成）：账户概览 / 持仓 / 成交 / 净值 / 绩效 / 风控 / 信号 / 升级进度（scripts/paper_dashboard.py 生成，每日复盘自动刷新；同目录 模拟盘看板.html 为交互预览版） | 看板 |
| 图谱导航图 | Obsidian 图谱结构导航（时间主干 / 枢纽 / 聚类） | 导航 |
| 图谱配置指南 | 图谱配色 / 分组 / 过滤配置说明 | 导航 |
| 数据库说明 | 数据源清单、可信度标签、目录规范与保留策略 | 数据 |
框架/（11）· 框架/模板/（2）· 框架/技能/（1）
| 文件 | 用途 | 状态 |
|---|---|---|
| 框架/Apple HIG 排版与交互规范 | 视觉与交互唯一口径 + 可交互演示：字体阶梯 / 表格 hairline / 卡片圆角 / 系统语义色；.obsidian/snippets/apple-hig.css 的唯一口径来源 | 必读 |
| 框架/排版与信息架构规范 | 排版与信息架构唯一口径：五类强调元素的可判定规则（emoji / 彩色胶囊 / 加粗 / 行内代码 / 链接）+ 标题级数 + 首页 5–9 区块 + 中文排版三件套 + 自检清单；配 scripts/typo_check.py 强制（只告警不阻断） | 必读 |
| 框架/数据口径定义 | 全局唯一口径（冲突时以此为准） | 必读 |
| 框架/终极决策框架 | 完整投资决策流程 | 主框架 |
| 框架/四因子模型总纲 | 核心分析模型 | v2 |
| 框架/四因子模型完善版 | 总纲的完善版实现说明 | 可用 |
| 框架/四因子决策框架·全景总结 | 决策框架整合视图 | 可用 |
| 框架/黄金主导因子切换(A-B-C) | 黄金状态机 A/B/C 判定 | A 态基率低 |
| 框架/Agent预测系统 | Agent 预测链算法与口径 | 待验证 |
| 框架/复盘 | 复盘索引（校正版）：口径说明 + 归档入口（总入口见 §七） | 索引 |
| 框架/使用指南 | 使用手册（文件结构 / 日常流程） | 查阅 |
| 框架/模板/标准化复盘生成流程 | 复盘生成 SOP（G1–G5 硬闸门 / 模板占位符说明） | 模板 |
| 框架/模板/排版优化模板 | iOS-tag 样式模板与复盘样式示例（仅排版占位示例） | 模板 |
| 框架/技能/duckerry-daily-review SKILL · reference | Agent 自动化技能 v1.9.5（模拟盘可视化版：新增 scripts/paper_dashboard.py——把 数据/paper/ 渲染成面向人的「真实账户视图」双产物 模拟盘看板（.md，iOS 胶囊样式）+ 模拟盘看板.html（github-markdown-css 排版 + Motion 物理动画，离线内嵌），Step 4 每步刷新且 fetch.py 发布后自动调用；承 v1.9.1 Apple HIG 全库落地 + 共享设计层 scripts/apple_style.py（快照/看板共用图标）+ §2.0 排版规范；承 v1.9.2 结构瘦身（零口径变更）；承 v1.8.0 提速版 preflight.py / selfcheck.py / daily_summary.py / tests_gate.py 四脚本与 SOP 九步；承 v1.7.5 A1 记录 / §6.3 骨架 / 绩效引用口径 / 外部资源红线 / doc_sync 13 项）；与 /var/minis/skills/ 主副本 md5 一致（66240fe8d3d90fa52c0e2016dfb088f4） | 技能 |
资产/（6）· 因子/（4）· 概念/（4）
复盘/（169 直属与按月 + 44 归档）
口径说明：§7.1/7.2（AUTO:INDEX）的
review_files只计复盘日产物（160，含数据缺失占位），不含 6 份直属总汇/专题/索引与 3 份数据治理（共 9 份）；与「169 直属与按月」口径不同，非漏登记。
| 分组 | 数量 | 入口 |
|---|---|---|
| 收盘复盘 | 99 | §7.2 全量索引（📕） |
| 收盘数据快照 | 32 | §7.2 全量索引（📸） |
| 盘前简报 | 25 | §7.2 全量索引（🌅） |
| 非交易日备忘 | 1 | §7.2 全量索引（🛌） |
| 数据缺失占位 | 3 | §7.2 全量索引（⚠） |
| 总汇 / 专题 / 索引 | 6 | 复盘/2026-06-01—2026-09-11 数据复盘总汇·校正版 · 复盘/深度复盘_SpaceX筹码交换与AI对黄金定价权的重构 · 复盘/Agent预测系统·状态总览 · 复盘/长期记忆-2026-08-16 · 复盘/历史原始记录索引 · 复盘/复盘索引 |
| 冻结归档（旧外推） | 44 | §7.4 → 复盘/历史原始记录索引 |
| 数据治理 | 3 | 复盘/数据治理/黄金主源403与备用源验证_2026-10-02 · 复盘/数据治理/真实数据重估_2026-09-09 · 复盘/数据治理/数据勘误报告_2026-09-09 |
optimization/（34）
| 文件 | 用途 | 状态 |
|---|---|---|
| optimization/提示词/继续任务提示词_2026-09-27_A1并行记录与外部资源接入 | 续接任务提示词（新对话冷启动用）：A1 并行记录接线 + 外部资源接入。自包含 v5.3 全上下文（卫星降权 / portfolio.py / 备忘 v1.1 / A1 新定义 / 最坏情形表 / 换腿首轮）+ 量化策略/ 9 仓库的可调用·只读·禁装三分层（含文件完整性体检结论：2093 个 .py 全部解析通过）；末节附可直接粘贴的最小提示词 | 已执行（见 §九 · v5.3.1） |
| optimization/提示词/继续任务提示词_2026-09-27_回测引擎v2.0与多资产 | 续接任务提示词（新对话冷启动用）：回测引擎 v2.0 → 多资产组合（阶段 1）。自包含离线上下文（已完成的 / 已证伪的 / 待办的 / 会踩的坑 / 登记规范 / 16 个已核实 GitHub 仓库 + 武器库登记方式），末节附可直接粘贴的最小提示词 | 已执行（阶段 1 已完成 = §九 · v5.2.5） |
| optimization/提示词/继续任务提示词_2026-09-27_v5.3.2同步优化_P3-③年化与收尾 | 续接任务提示词（新对话冷启动用）：v5.3.2 交接续作 —— P3-③ engine_multi 年化口径统一 bar/ppy（含全量复算验收口径与还原兜底）+ 收尾（REVERT.md / 三件套 / 逐类测试 / 记忆）。自包含：已完成 P0/P1/P2/P3-① 全清单 + 变更 md5 + 登记规范 + 已知坑 + 红线；末节附可直接粘贴的最小提示词 | 待执行 |
| optimization/报告/决策备忘_核心底仓是否改为金加纳指_2026-09-27 | 决策备忘 v1.1（已拍板）：核心底仓是否从「纯黄金」改为「金+纳指」。给出三问（a 改不改 / b 配比 / c 卫星去留）的证据与选项、口径警告、已拍板：a=A1 并行记录不下单（改定义：+最坏情形具象化 +换腿稳健性检验）· b=逆波动率/周数据/季调仓/5% 偏离带 · c=卫星立即降权（已执行）；明确不建议组合层大改与引入 ERC/HRP | 已拍板 |
| optimization/报告/四因子框架回测引擎v2.0_报告_2026-09-27 | 回测引擎 v2.0 报告：按三条指令（降频 / 宏观否决权 / 核心60%+卫星40%）重构后的否定式发现 —— 等敞口对比下自适应卫星收益/夏普/回撤三项全输（→ 卫星无 alpha）；样本外夏普 0.286→0.754（降频有效）；列出 P1 方法论 7 项 + P2 已修 4 项 + P3 数据 4 项 + iSH 环境 3 项；给出「换问题不换参数」的 4 条改进方向与 16 个 GitHub 参考仓库（API 实测核实）；资产曲线 wf/ curves/ 随引擎入库 | 最新 |
| optimization/待办与交接/架构风险审计待办_v5.2.3_2026-09-26 | 架构风险审计待办（v5.2.3 加固）：高级架构风险审计官【纯只读审计】结论 → 可执行待办，1×P0 + 4×P1 + 5×P2（熔断计数器无复位 / cost_est 未接线 / 台账锁无逃生 / SOP 脱节 / state/current.md 零监护 / AUTO:INDEX 不自愈 / 状态证据跨 run 混入 / doc_sync 第 8 项假绿 / 240s↔480s 口径 / recompute3 孤儿）；含 7 项「已验证无风险」与 4 批次执行纪律 + DoD | 最新 |
| optimization/报告/仓库文件修改建议_2026-09-26 | 只读评审 → 文件级修改建议清单（A–H 八维度 / 7 列建议表 / 14 条建议：P0 0·P1 3·P2 6·P3 5 / 4 批次执行顺序；健康度=好，机械自检全绿） | 最新 |
| optimization/提示词/仓库文件修改建议提示词_2026-09-26 | 仓库文件修改建议提示词（只读评审 → 7 列建议表 + 批次执行） | 最新 |
| optimization/报告/v5.2.1 二级源回退与债券盘中价修复报告_2026-09-26 | v5.2.1 报告：二级源 VIX 回退守卫修复 + 债券腿「盘中伪收盘」拦截与自愈 | 最新 |
| optimization/报告/v5.2 二级源与空头腿落地报告_2026-09-25 | v5.2 报告：二级源消盲区 + 未复权债券真实收盘 + 模拟盘空头/减仓腿 + A/B/C 机械证据 | 最新 |
| optimization/报告/路径防呆与导航可达性修复报告_2026-09-24 | v5.1 报告：写入路径防呆 + 导航可达性（review_write / moc_index --verify / 10 项自检） | 最新 |
| optimization/报告/系统架构优化报告_2026-09-23_v5.0 | v5.0 报告：驾驶舱统一管理 + 死链/孤儿清零 + 分类收敛 + 架构自检（本报告） | 最新 |
| optimization/报告/系统状态一致性修复报告_2026-09-23 | v5.0.1 报告：驾驶舱状态一致性修复（A-G 问题）+ 未修项登记 | 最新 |
| optimization/提示词/继续任务提示词_2026-09-25_v5.2二级源与空头腿 | v5.2 任务提示词：二级源消盲区 + 债券真实收盘 + 模拟盘空头/减仓腿 | 已执行 |
| optimization/提示词/系统优化提示词_2026-09-23_v5.0_架构与驾驶舱统一管理 | v5.0 任务提示词：架构与驾驶舱统一管理 | 已执行 |
| optimization/提示词/系统优化提示词_2026-09-23_v4.3_债券腿入管线与全库自检 | 一次性优化：债券腿入管线 + 全库自检 | 已执行 |
| optimization/提示词/每日发布运行提示词_2026-09-23 | 每日发布交接包（新对话直接粘贴） | 最新 |
| optimization/提示词/每日发布运行提示词_2026-09-22 | 上一版发布交接包（v4.1，留档） | 归档 |
| optimization/报告/系统架构优化报告_2026-09-23 | v4.2 债券腿日更 + 武器库接入 | 报告 |
| optimization/报告/系统架构优化报告_2026-09-22 | v4.0 架构重排 + 稳定性加固 | 报告 |
| optimization/报告/系统审计与重构报告_2026-09-11 | 首轮全面审计（21/100，19 项发现） | 归档 |
| optimization/报告/系统审计与重构报告_2026-09-11_v2 | 可复核化 + 分册化 + 证据包 | 归档 |
| optimization/报告/系统审计与重构报告_2026-09-13_v2.1修复后 | v2.1 修复后全库审计报告 | 归档 |
| optimization/提示词/系统优化提示词_DUCKERRY_Warehouse_v1 | 初版系统级审计重构优化提示词 | 归档 |
| optimization/报告/系统优化提示词_DUCKERRY_Warehouse_v2.0_全方位审计与重构 | v2.0 全方位审计与重构提示词 | 归档 |
| optimization/提示词/每日复盘与开盘日自动化提示词_DUCKERRY_Warehouse_v1.0 | 每日复盘/开盘日自动化初版提示词 | 归档 |
| optimization/提示词/未完成任务交接提示词_2026-09-21 | 09-21 未完成任务交接（历史遗留清单） | 归档 |
| optimization/报告/全库修复报告_2026-09-12 | 09-12 全库修复报告 | 归档 |
| optimization/报告/修复记录_2026-09-13 | 09-13 修复变更记录 | 归档 |
| optimization/报告/优化总结_20260816 | 08-16 模型优化总结 | 归档 |
| optimization/报告/参数优化建议_20260816 | 08-16 参数优化建议 | 归档 |
| optimization/报告/性能监控报告_20260816 | 08-16 性能监控报告 | 归档 |
| optimization/报告/模式性能评估_20260816 | 08-16 模式性能评估 | 归档 |
说明：08-16 的 4 份为早期（旧数据口径）评估，仅作历史留档；当前有效口径以 框架/数据口径定义 与 §〇 架构表为准。
audit_evidence/（6）
| 文件 / 目录 | 用途 |
|---|---|
| audit_evidence/index | 证据包目录索引（入口） |
audit_evidence/manifest.json | 证据清单 + sha256 校验（JSON，非笔记） |
| audit_evidence/scoring_rubric | 14/100 健康评分细则 |
| audit_evidence/recompute_map | 结论 → 证据 → 脚本 → 命令 → 输出 → 检查 映射 |
| audit_evidence/redteam_independent | 🔴 红队独立审计 |
| audit_evidence/self_check | 自检清单 |
| audit_evidence/logs/index | 证据包运行日志索引 |
audit_evidence/data/ audit_evidence/scripts/ | 原始快照数据 / 复算脚本（目录，非 md） |
⚠ 本目录为审计证据包：日常决策不要打开，只在复核数据真实性或追溯某条结论的计算过程时查阅。
回测/（10 个文件：2 笔记 + 8 文本）· 回测/engine_v1/（引擎，独立可运行）
| 文件 | 用途 | |
|---|---|---|
| 回测/README | 目录说明 + 文件重命名映射表（v5.0 新增） | |
| 回测/回测审核清单_backtest_pitfalls | 回测审核清单（研究层，v5.3.2 新增；2026-10-02 扩至 16 条）：把 ML4T 教材「回测陷阱」章节转成 16 条可执行审核项（前视偏差 / 幸存者 / 数据窥探·多重检验 / 成本与滑点 / 样本外与参数稳定性 / 复权·分红 / 频率与年化口径 / 单一资产 beta 与分散幻觉 …/ 第 15 条 似然退化·方差参数弱识别 → 边界解 / 第 16 条 阈值闸·状态闸的工程校验），并对本库 engine_v1·engine_multi·perf_audit 三处产出逐条机械自查（结果 1 违背 + 3 存疑，违背项不就地修改；该违背项已于 v5.3.2 单独授权修复；第 15/16 条对三处产出不适用，见 v5.3.3） | checklist |
| 回测/engine_v1/README | 回测引擎 v2.0 使用说明（--freq 降频 / 否决权 / 核心卫星 / walk-forward；口径边界与 iSH 备注）→ 报告见 optimization/报告/四因子框架回测引擎v2.0_报告_2026-09-27 | |
回测/engine_v1/duckerry_backtest.py | 主引擎（约 1490 行，单文件零联网可直接运行，只读 数据/） | |
回测/engine_v1/plot_compare.py | 独立绘图脚本（从已落盘 equity.csv 出图） | |
回测/engine_v1/compare.csv compare_curve.png | 六策略横向对比表与净值图（对数轴） | |
回测/engine_v1/curves/*.csv | 各策略净值曲线（date, equity, dd, sat_pos） | |
回测/engine_v1/wf/ | 样本外 walk-forward：oos_equity.csv + oos_summary.json + fold_0..5.json | |
回测/engine_v1/metrics_weekly_core60.json | 主推配置（周频·自适应+核心60%）完整指标 + 实际生效 config | |
| 回测/engine_multi/README | 多资产组合回测模块（阶段 1）使用说明：等权 1/N / 逆波动率 / 风险平价 ERC（手写迭代，不引外部库）+ 数据频率与再平衡频率分离 + WTI 负价守卫；产出五张表（全样本 / 子区间 / 子区间对齐口径 / 同风险对比 / 再平衡×成本矩阵 / 分段相关系数）→ 金+纳指风险平价 41 年夏普 0.856（复现交接件 0.88）、加 WTI 反而降到 0.766 | |
| 回测/kalman/README | 卡尔曼滤波特征（研究层，2026-10-02 新增）：纯 numpy/scipy 局部线性趋势滤波器 + MLE + 向前滚动重估产出 4 个点内特征（kf_level/kf_slope/kf_innovation/kf_uncertainty）+ 动态对冲比率，嵌进 engine_v1 的 L1 动量与趋势态判定做样本外 A/B。结论：无改善（Δ夏普 +0.037/+0.025，门槛 ≥+0.10）→ 不引入；并实测似然退化（三参数 100% 钉在事前边界、放松边界 nll 仍下降）→ 已登记为审核清单第 15 条。详见 回测/kalman/报告_卡尔曼嵌入评估_2026-10-02 | |
| 回测/perf_audit/README | 绩效指标交叉验证（研究层只读审计）：用第三方 quantstats 0.0.85 复算我方全部对外绩效指标。波动率/最大回撤 28 项全 PASS、夏普全 PASS（手写核心实现验证通过）；唯一实质差异是索提诺定义不同（已定位到源码）；并量化出年化口径分歧——engine_v1 的 bar/ppy 与 quantstats 同源（差 0.08% = round(4)），engine_multi 的日历跨度差 0.36% → 拍板年化一律以 bar/ppy 为准（v1.1 已修复 qs.stats.calmar 漏传 periods 的卡玛高估） | |
回测/engine_multi/multiasset_backtest.py | 主模块（约 1000 行，单文件零联网，只读 数据/；全时段批量滚动矩 + 向量化净值路径） | |
回测/engine_multi/plot_multi.py curves_compare.png | 独立绘图脚本与组合净值对比图（对数轴，ASCII 图例） | |
回测/engine_multi/tables/*.csv | 表 A 全样本 / B 子区间 / B2 子区间·对齐口径 / C 同风险对比 / D 再平衡×成本矩阵 / E 分段相关系数（+ 守卫日志.json） | |
回测/engine_multi/curves/*.csv | 组合净值曲线（date, equity）与各资产归一化价格 | |
| [回测_相对最优策略_源码.txt](回测/回测_相对最优策略_源码.txt) | 四因子框架版相对最优策略脚本（L0–L4 + 动态参数） | |
| [回测_相对最优策略V2.0_源码.txt](回测/回测_相对最优策略V2.0_源码.txt) | V2.0 参数贴合实盘风格版 | |
| [回测_相对最优策略结果摘要.txt](回测/回测_相对最优策略结果摘要.txt) | v3 修正版真实数据（2021–2025）核心指标 | |
| [回测_实盘风格_结果摘要.txt](回测/回测_实盘风格_结果摘要.txt) | 「回调止跌买入 / 2.5% 止盈 / −15% 硬扛」回测结果 | |
| [回测_傻子策略_源码.txt](回测/回测_傻子策略_源码.txt) | 连续两阴线 + 第三根实体收窄 入场策略脚本 | |
| [回测_傻子策略_结果摘要.txt](回测/回测_傻子策略_结果摘要.txt) | 傻子策略回测结果 | |
| [回测_四因子框架五年回测引擎v2_源码.txt](回测/回测_四因子框架五年回测引擎v2_源码.txt) | 五年日线级回测引擎 v2（L0–L4 全嵌入） | |
| [回测_四因子框架精简纯净版_源码.txt](回测/回测_四因子框架精简纯净版_源码.txt) | 精简纯净版（纯多头择时，无动态优化） |
scripts/（管线脚本，不参与目录计数）
| 分组 | 脚本 |
|---|---|
| 发布主线 | fetch.py（一键入口）→ dkfetch.py → dkpanel.py → dkanalysis.py → regime_hybrid.py → brier_calibration.py → paper_engine.py → predict_regime_conditional.py |
| 债券腿 | refresh_bond_etf.sh + update_bond_etf.py |
| 自检 | doc_sync_check.py（v4.3，11 项）+ arch_check.py（v5.0 新增，v5.2.3 升 11 项） + moc_index.py（v5.0 新增，导航层，不参与判据） |
| 复算 | recompute2.py recompute4.py validate_prediction.py（v5.2.3：零引用孤儿 recompute3.py 已移入 scripts/legacy/） |
| 工具 | dkpaths.py publish_status.sh reset_paper_state.py state_digest.py（v1.7.0 新增，v5.2.3 加固：状态摘要 + 分桶熔断 + --cost/--reset/--guard） |
| 归档 | scripts/legacy/（09-13 时代一键修复脚本 7 个 + 09-19 新增 calibrate.py/validate_0918.py + v5.2.3 移入 recompute3.py，共 9 个，只读） |
| 历史证据（不作为判据） | audit_evidence/（一次性审计题库/评分表/平行脚本副本）与 scripts/legacy/：均为历史存档，只读保留、不参与当前发布/自检判据（v5.2.3 D-5 明确） |
| 依赖 | scripts/pandas_market_calendars/（NYSE/LSE 官方日历包） |
state/（运行态，1）
| 文件 | 用途 | 状态 |
|---|---|---|
| state/current | 当前状态摘要（由 scripts/state_digest.py 覆盖写，≤500 字）：target/gate/L0/L1/regime/pattern/aux/paper/brier/doc_sync + ≤5 行日志证据；v1.7.0 起模型每 ≤3 步只读此文件（上下文剪枝）；v5.2.3：覆盖前留 current.md.bak，且只允许 state_digest.py 写入（手工编辑违规） | 自动生成 |
state/budget.json（非笔记） | 分桶计数 loops_by / cost_by（键 = <YYYY-MM-DD>|<MODE>）+ 当前桶 loops/cost_est/连续无进展，供 state_digest.py --guard 熔断判定（max_loops: 15 / max_budget: 0.5，成本须传 --cost）；跨日或换 mode 自动从 0 起算（v5.2.3） | 自动生成 |